Document Despair Engine Lua API and recover FEAR 3 scripts - #1

Summary

• Build a reproducible API reference covering 3,879 paths across 330 namespaces, with a JSON catalog and documented extraction limitations.
• Preserve the original reconstruction artifacts and add analysis, contribution guidance, and CI validation.
• Add 43 recovered boot scripts and 228 resources scripts, preserving directory structure and recording provenance and per-file validation.
• Add recovery tooling that compares LuaDec, unluac, and optional cLuaDecompiler output; all 271 selected scripts reproduced the original executable Lua 5.1 prototype trees after recompilation.

Validation

• All 16 unit tests pass: python -m unittest discover -s tests -v
• Generated reference is current: python tools/build_api.py --check
• git diff --check passes

Limitations

• Recovered scripts have not been executed in the game; comments and original formatting cannot be recovered.
• cLuaDecompiler was run on the resources scripts using the user-supplied binary. The earlier boot recovery used LuaDec/unluac.
• External binaries, original binary chunks, and large diagnostic archives are not committed. Provenance and validation manifests are included.